home *** CD-ROM | disk | FTP | other *** search
/ Aminet 12 / Aminet 12 (1996)(GTI - Schatztruhe)[!][Jun 1996].iso / Aminet / misc / edu / Calgor.readme < prev    next >
Encoding:
Text File  |  1996-05-05  |  10.7 KB  |  262 lines
  1. Short:    C Algorithm Demonstrator
  2. Author:   Dave@roke.demon.co.uk
  3. Uploader: Dave@roke.demon.co.uk
  4. Version:  V1.21
  5. Type:     misc/edu
  6. Requires: 1MB Chip 1/2MB Other
  7.  
  8. Readme - Calgor V1.21 - 23/3/96
  9.  
  10. Introduction
  11.  
  12. Calgor started life as third year University project (under the
  13. heading of Demonstrations of Computer Science).  The primary goal
  14. being to create an environment where the user could learn about
  15. different algorithms and their design.  It is based on two
  16. different learning strategies, that of drill and rote and
  17. learning through personal experimentation.
  18.  
  19. You may use Calgor as is, The player comes with the following
  20. installed:-
  21.  
  22. Demonstrations of While, Do While, For, If and Switch C program
  23. control statements. Array data structure example, Insertion,
  24. Selection, Bubble and Quick Sort Algorithms (all with .txt files
  25. explaining their mechanics).
  26.  
  27. Or if you have a C compiler you can use it to animate your own C
  28. algorithms (See the Calgor Programming Manual for details).
  29.  
  30. Requirements
  31.  
  32. Calgor needs 1 MB chip ram, 1/2 MB Other Ram, Workbench 2.04+ and
  33. one out of the following fonts installed: helvetica 13,  times
  34. 11, courier 11 or napsa 11.  Calgor is run from Workbench,
  35.  
  36. Running From Disk
  37.  
  38. Double click on the Calgor Icon and the program will run.  You
  39. may have to alter data/editor.dat to point at your favourite text
  40. viewer, default is set to "ed" (To do this just edit
  41. data/editor.dat with a text editor).  If you are going to program
  42. your own C algorithms, you will need to copy the hold directory
  43. to your compilers header search path (The default directory used
  44. by Dice is Dinclude:).
  45.  
  46. Installing Disk To Hard Drive
  47.  
  48. Just copy the Disk "Cal" to the destination directory you
  49. want (by dragging the Disk Icon Cal over to the directory).
  50.  
  51. Place in the s:user-startup an Assign, which assigns The Volume
  52. Cal: to the directory path leading to Calgor directory.
  53.  
  54. E.g.
  55.  
  56. I have copied Cal over to "Work:programming/" so the assign
  57. would be
  58.  
  59. "Assign Cal: Work:programming/Cal"
  60.  
  61. Reboot, then just double click on the Calgor Icon to run.
  62. Double click on the Calgor Icon and the program will run.  You
  63. may have to alter Cal:data/editor.dat to point at your favourite
  64. text viewer, default is set to "ed" (To do this just edit
  65. data/editor.dat with a text editor).
  66.  
  67. If you are going to program your own C algorithms, you will need
  68. to copy the hold directory to your compilers header search path
  69. (the default directory used by Dice is Dinclude:).
  70.  
  71. Instructions For Use: Program, Menu
  72.  
  73. Use the Function keys (F1-F5) to select the heading and the
  74. number keys (1-5) to select the options.  Alternatively you can
  75. use the mouse and left click on either the function key graphic
  76. to select the heading, or the key graphic to select the option.
  77. Clicking on the exit box or pressing ESC will exit from the
  78. program.
  79.  
  80. You may at any time press Left Amiga and M to flick through the
  81. different screens and hence get back to the workbench (This will
  82. have the affect of putting Calgor to sleep).  To restore
  83. Calgor, go to the Workbench Menus and select the Tools
  84. "Restore_Calgor" Option.
  85.  
  86. Keys: Menu:
  87.  
  88. F1:  Heading-Option Bank 1      Num Key 1       Option 1
  89. F2:  Heading-Option Bank 2      Num Key 2       Option 2
  90. F3:  Heading-Option Bank 3      Num Key 3       Option 3
  91. F4:  Heading-Option Bank 4      Num Key 4       Option 4
  92. F5:  Heading-Option Bank 5      Num Key 5       Option 5
  93.  
  94. Left Amiga and M - Put Calgor to sleep.
  95.  
  96. To play an animation
  97.  
  98. The animation menu has six functions, Play, Fast Forward, Pause,
  99. Stop, Eject and Information, to initiate a function just click on
  100. their respective graphics or press the appropriate keys (see
  101. below).
  102.  
  103. Keys, Animation Menu
  104.  
  105. Num Key 1 - Play
  106. Num Key 2 - Fast Forward (Accumulative)
  107. Num Key 3 - Pause
  108. Num Key 4 - Stop
  109. Num Key 5 - Information
  110. ESC       - Eject or Stop (Depends on if an animation is playing
  111.             or not).
  112.  
  113. The information function may only be accessed when the animation
  114. is paused or stopped and will cause the .txt file for that
  115. demonstration to be displayed via the text editor named in
  116. data/editor.dat.
  117.  
  118. Specification
  119.  
  120. This version of Calgor (V1.21) is limited in what it can do.
  121. Since I'm starting a whole new project, anyone wishing to further
  122. this one, may get into contact with me via Email.
  123.  
  124. Calgor can model the behaviour of an integer array, maximum 10
  125. elements per program.  Calgor can model 10 integer variables
  126. per function.
  127.  
  128. The animation functions (see programming manual for specifics),
  129. use a limited parser to assess values.  It can evaluate absolute
  130. number (10), variable (x),  array with variable (a[x]), array
  131. with absolute offset (a[10]), or variable and integer offset
  132. (a[x+10]), however these are fixed in stone, a[b[9]] would not be
  133. evaluated properly.
  134.  
  135. Calgor does not model structure or pointer behaviour.
  136.  
  137. Errors
  138.  
  139. If at anytime Calgor produces an error it will record it
  140. "CalLog".  A more detailed error message may be produced if
  141. Calgor is run from the CLI.
  142.  
  143. Bugs.
  144.  
  145. 1).  When using a hi-res intuition pointer (WB 3.0), Calgor
  146. doesn't display it's pointer correctly.
  147.  
  148. 2).  Using a 68030, with low memory, and datacaches enabled,
  149. the menu text sometimes corrupts.  Calgor fixes this by switching
  150. off the datacaches (via the cpu command) when it starts.  The
  151. datacaches are enabled when you exit from Calgor.
  152.  
  153. To switch data caches off type (in a CLI):
  154. CPU nodatacache <RETURN>
  155. To switch data caches back on, type
  156. CPU datacache <RETURN>
  157.  
  158.  
  159. ============================= Archive contents =============================
  160.  
  161. Original  Packed Ratio    Date     Time    Name
  162. -------- ------- ----- --------- --------  -------------
  163.     1233     593 51.9% 23-Mar-96 17:16:44  Cal.info
  164.     1233     594 51.8% 22-Mar-96 18:13:56 +Algorithms.info
  165.      723     292 59.6% 21-Mar-96 17:38:12 +array.c
  166.     1405     462 67.1% 19-Mar-96 17:37:12 +bubble.c
  167.      987     300 69.6% 19-Mar-96 17:36:40 +do_while.c
  168.     1086     290 73.2% 19-Mar-96 17:36:08 +For.c
  169.     1680     439 73.8% 19-Mar-96 17:35:22 +if_else.c
  170.     1336     458 65.7% 19-Mar-96 17:34:26 +insertion.c
  171.     2182     625 71.3% 19-Mar-96 17:33:46 +quick.c
  172.     1550     498 67.8% 19-Mar-96 17:32:54 +selection.c
  173.     1346     363 73.0% 19-Mar-96 17:32:12 +switch.c
  174.     2189     630 71.2% 19-Mar-96 17:38:04 +user1.c
  175.     1389     591 57.4% 22-Mar-96 02:24:56 +user1.c.info
  176.     2187     629 71.2% 19-Mar-96 17:39:08 +user2.c
  177.     1389     592 57.3% 22-Mar-96 02:24:56 +user2.c.info
  178.     2189     631 71.1% 19-Mar-96 17:40:14 +user3.c
  179.     1389     591 57.4% 22-Mar-96 02:24:56 +user3.c.info
  180.     2189     630 71.2% 21-Mar-96 23:29:30 +user4.c
  181.     1389     593 57.3% 22-Mar-96 02:24:58 +user4.c.info
  182.     2189     630 71.2% 19-Mar-96 17:42:34 +user5.c
  183.     1389     591 57.4% 22-Mar-96 02:24:58 +user5.c.info
  184.     1028     294 71.4% 19-Mar-96 17:31:40 +while.c
  185.     1233     597 51.5% 22-Mar-96 18:13:56 +C.info
  186.     9020    5518 38.8% 22-Mar-96 02:48:00 +what
  187.    57720   28695 50.2% 22-Mar-96 18:41:24 +calgor
  188.     1585     739 53.3% 21-Mar-96 23:42:18 +calgor.dice
  189.     1436     861 40.0% 22-Mar-96 18:13:56 +calgor.dice.info
  190.      890     226 74.6% 22-Mar-96 18:42:56 +Calgor.info
  191.       15      15  0.0% 22-Mar-96 18:48:20 +CalLog
  192.     1499     580 61.3% 22-Mar-96 18:13:56 +CalLog.info
  193.     1233     598 51.5% 22-Mar-96 18:13:56 +CalSource.info
  194.    19319    4653 75.9% 22-Mar-96 00:27:38 +allanim.c
  195.     1181     495 58.0% 22-Mar-96 00:30:36 +control.c
  196.     3799    1244 67.2% 22-Mar-96 00:29:28 +filter.c
  197.    30534    7980 73.8% 22-Mar-96 18:40:58 +menus.c
  198.     6369    2212 65.2% 20-Mar-96 20:50:18 +mouse.c
  199.      524     299 42.9% 22-Mar-96 02:11:46 +ports.c
  200.    40536   10544 73.9% 22-Mar-96 00:26:10 +sysanim.c
  201.     1233     596 51.6% 22-Mar-96 18:13:56 +Data.info
  202.       80      57 28.7% 23-Apr-95 06:31:14 +Dem.dat
  203.        3       3  0.0% 21-Mar-96 20:29:54 +editor.dat
  204.       80      55 31.2% 20-Apr-95 23:04:04 +menu.dat
  205.      380     183 51.8% 11-Mar-96 15:12:26 +options.dat
  206.       20      15 25.0% 20-Apr-95 15:24:06 +pulse.dat
  207.     1648    1132 31.3% 22-Mar-96 03:22:54 +Disk.info
  208.     1233     593 51.9% 22-Mar-96 18:13:56 +Docs.info
  209.      133     113 15.0% 22-Mar-96 02:42:52 +Author
  210.     1499     581 61.2% 22-Mar-96 03:09:08 +Author.info
  211.      609     359 41.0% 23-Mar-96 17:11:20 +Legal
  212.     1499     582 61.1% 22-Mar-96 03:09:10 +Legal.info
  213.    11007    3567 67.5% 22-Mar-96 01:28:34 +Manual
  214.     1499     581 61.2% 22-Mar-96 03:09:06 +Manual.info
  215.     5262    2299 56.3% 23-Mar-96 17:13:24 +Readme
  216.     1499     579 61.3% 22-Mar-96 03:09:10 +Readme.info
  217.      444     261 41.2% 22-Mar-96 03:39:22 +What
  218.     1499     582 61.1% 22-Mar-96 03:09:08 +What.info
  219.      628     262 58.2% 22-Mar-96 18:13:56 +hold.info
  220.     1271     475 62.6% 22-Mar-96 00:31:28 +anim.h
  221.     1000     416 58.4% 22-Mar-96 00:32:38 +data.h
  222.       44      44  0.0% 22-Apr-95 03:07:28 +demmap.h
  223.     4631    1648 64.4% 22-Mar-96 16:54:56 +extra.h
  224.      588     164 72.1% 22-Mar-96 00:31:48 +funchead.h
  225.     1233     593 51.9% 22-Mar-96 18:13:56 +Pic.info
  226.   163840    1538 99.0% 30-Aug-95 21:51:42 +Dem2.pic
  227.   163840    1671 98.9% 09-May-95 02:03:10 +Dump.pic
  228.   163840    5734 96.5% 22-Mar-96 02:38:34 +MenuV1_21.pic
  229.     1233     594 51.8% 22-Mar-96 18:13:56 +Text.info
  230.     1821     797 56.2% 22-Mar-96 02:16:22 +Array.txt
  231.     1499     574 61.7% 22-Mar-96 02:27:26 +Array.txt.info
  232.     3020     900 70.1% 14-Mar-96 16:48:22 +Bubble.txt
  233.     1499     578 61.4% 22-Mar-96 02:27:14 +Bubble.txt.info
  234.     1646     468 71.5% 10-Feb-96 16:42:00 +Do_while.txt
  235.     1499     577 61.5% 22-Mar-96 02:27:12 +Do_while.txt.info
  236.     1973     544 72.4% 10-Feb-96 16:40:02 +For.txt
  237.     1499     579 61.3% 22-Mar-96 02:27:14 +For.txt.info
  238.      344     171 50.2% 21-Mar-96 20:31:16 +If_Else.txt
  239.     1499     578 61.4% 22-Mar-96 02:27:16 +If_Else.txt.info
  240.     2604     955 63.3% 14-Mar-96 16:47:54 +Insertion.txt
  241.     1499     578 61.4% 22-Mar-96 02:27:14 +Insertion.txt.info
  242.     5353    1655 69.0% 14-Mar-96 03:59:58 +Quick.txt
  243.     1499     578 61.4% 22-Mar-96 02:27:18 +Quick.txt.info
  244.     2415     810 66.4% 14-Mar-96 16:47:28 +Selection.txt
  245.     1499     578 61.4% 22-Mar-96 02:27:20 +Selection.txt.info
  246.     2523     637 74.7% 10-Feb-96 16:36:44 +Switch.txt
  247.     1499     577 61.5% 22-Mar-96 02:27:18 +Switch.txt.info
  248.     5362    1657 69.0% 22-Mar-96 17:42:12 +user1.txt
  249.     1499     578 61.4% 22-Mar-96 02:27:18 +user1.txt.info
  250.     5363    1657 69.1% 14-Mar-96 16:08:52 +User2.txt
  251.     1499     580 61.3% 22-Mar-96 02:27:22 +User2.txt.info
  252.     5362    1660 69.0% 14-Mar-96 16:13:10 +User3.txt
  253.     1499     578 61.4% 22-Mar-96 02:27:24 +User3.txt.info
  254.     5363    1657 69.1% 14-Mar-96 16:14:56 +User4.txt
  255.     1499     577 61.5% 22-Mar-96 02:27:24 +User4.txt.info
  256.     5362    1657 69.0% 22-Mar-96 17:44:26 +User5.txt
  257.     1499     576 61.5% 22-Mar-96 02:27:24 +User5.txt.info
  258.     1666     454 72.7% 10-Feb-96 16:36:26 +While.txt
  259.     1499     576 61.5% 22-Mar-96 02:27:22 +While.txt.info
  260. -------- ------- ----- --------- --------
  261.   815007  126190 84.5% 23-Mar-96 18:28:32   97 files
  262.